home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / langs / iconv8_l.arc / IDOL.ARC / IDOL.MAN < prev    next >
Encoding:
Text File  |  1990-03-19  |  2.1 KB  |  51 lines
  1. NAME
  2.     idol - Icon-Derived Object Language
  3.  
  4. SYNOPSIS
  5.     idol -install
  6.     idol [ option ... ] mainfile otherfiles... [-x arguments]
  7.  
  8. DESCRIPTION
  9.     Idol is an object-oriented preprocessor for Version 7.5+ Icon.
  10.     It is a front-end for icont(1); typically one invokes idol on
  11.     a source file (extension .iol) which is translated into an
  12.     Icon source file (extension .icn) which is translated into a
  13.     file suitable for interpretation by the Icon interpreter.
  14.     Each directory containing Idol source files should be initialized
  15.     by "idol -install" prior to translating any user sources.
  16.     Producing an executable is skipped when the first file on the
  17.     list contains only classes.
  18.  
  19.     The following options are recognized by idol:
  20.  
  21.     -c       Suppress the linking phase
  22.     -t       Suppress all translation by icont
  23.     -s       Suppress removal of .icn files after translation by icont
  24.     -quiet   Suppress most Idol-specific console messages
  25.     -install Install the Idol environment in the current directory
  26.     -strict  Generate code which is paranoid about ensuring encapsulation
  27.     -version Print out the version of Idol and its date of creation
  28.  
  29.     The second and following files on the command line may include
  30.     extensions .icn, .u1, and .cl.  The first two Idol treats as
  31.     Icon source code which should be translated and linked into the
  32.     resulting executable.  Files with extension .cl are treated as
  33.     class names which are linked into the resulting executable.
  34.     If no extension is given, Idol attempts to find the desired
  35.     source file by appending .iol, .icn, .u1, or .cl in that order.
  36.  
  37. FILES
  38.  
  39.    ./prog.iol                     : source file
  40.    ./prog.icn                     : code generated for non-classes in prog.iol
  41.    ./idolcode.env/i_object.*      : Icon code for the universal object type
  42.    ./idolcode.env/classname.icn   : Icon files are generated for each class
  43.    ./idolcode.env/classname.u[12] : translated class files
  44.    ./idolcode.env/classname       : class specification/interface
  45.  
  46. SEE ALSO
  47.  
  48.    "Programming in Idol: An Object Primer"
  49.    (U of Arizona Dept of CS Technical Report #90-10)
  50.    serves as user's guide and reference manual for Idol
  51.